home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / dosutils / av611.zip / AV.DOC < prev    next >
Text File  |  1996-11-30  |  10KB  |  225 lines
  1. AV.DOC                               1                         Revised: 11-30-96
  2.  
  3. The AV.EXE program shows a directory of one or more  archive  files  (ZIP,  ZOO,
  4. etc), including some self-extracting files.  Features of this program:
  5.  
  6.   * The directory information is presented in full-screen mode and you can
  7.     use PgUp and PgDn to scroll about the screens.
  8.   * Allows you to sort the display of the members in a number of ways.
  9.   * Allows you to reset the file date of the archive to match the date of
  10.     the most recent member of the archive.
  11.   * Provides the ability to filter out what members are displayed.
  12.   * Scroll through up to 500 archives.
  13.   * The date format shown is based on your country setting.
  14.  
  15.  
  16. A typical display might look (in part) like the following:
  17.  
  18. AV602.ZIP         Date      Time  OrigSize Method    NowSize  %reduce
  19. ------------  --------  -------- --------- -------- --------  -------[PgUp]
  20. AV.DOC        96/02/04  18:32:36      8585 Deflated     3395    61   [PgDn]
  21. AV.EXE        96/02/11  11:09:56    166744 Deflated   107879    36   [Home]
  22. BRUCE602.DOC  96/02/05  20:31:56     32493 Deflated    12566    62   [End]
  23. BRUCEINI.DOC  96/01/20  16:09:18      7649 Deflated     2891    63   [Up]
  24. FILE_ID.DIZ   96/01/28  12:26:36       214 Deflated      191    11   [Down]
  25.                                                                      [Sort]
  26.                                                                        [Name]
  27.                                                                        [Ext]
  28.                                                                        [Date]
  29.                                                                        [Size]
  30.                                                                        [CurSize]
  31.                                                                        [Ratio]
  32.                                                                        [Path]
  33.                                                                        [Orig]
  34.                                                                        [-Flip]
  35.                                                                      [Filter]
  36.                                                                      [C-PgDn]
  37.                                                                      [C-PgUp]
  38.                                                                      [Quit]
  39.  
  40. ============  ========  ======== ========= ======== ========  =======[Help]
  41.  *5           96/02/11  11:09:56    215685            126922    42%  [Date]
  42. AV602.ZIP     96/02/11  11:10:16    127418                                  /ON
  43.  
  44.  
  45. Note that AV will not do much good for multi-disc ZIP files.
  46.  
  47.  
  48. AV.DOC                               2                         Revised: 11-30-96
  49.  
  50. When viewing a screen's worth of information, you can typically choose  among  a
  51. number of options including the following:
  52.  
  53.         PgUp    view the previous screen's worth
  54.         PgDn    view the next screen's worth
  55.         Home    top line
  56.         End     bottom line
  57.         Up      move the screen up one line
  58.         Down    move the screen down one line
  59.         Sort    change the sort order for this and subsequent files;
  60.                 you're prompted for "BY?" and you should enter either
  61.                 "-x" or "x" or press Esc to get out of this: the archive
  62.                 is reread after you ask to re-sort it; x is one of:
  63.                         N = file name
  64.                         E = file extension
  65.                         S = file size of the original (non-compressed) file
  66.                         C = current (compressed) size of the file
  67.                         D = file date and time
  68.                         R = compression ratio
  69.                         P = path and file name order
  70.                         O = original order (no sorting)
  71.                 the "-" says to reverse the sort order (e.g. biggest files
  72.                 first instead of last)
  73.         Filter  prompts you for a string; only member names that match that
  74.                 string are allowed through (does not accept wildcards; just say
  75.                 something like "COM" if you want all COM files)
  76.         Ctrl-PgDn go to the next archive file (if any)
  77.         Ctrl-PgUp go to the previous archive file (if any)
  78.         Quit    return to DOS (Ctrl-C also works) (with confirmation)
  79.         Date    update the archive file date to be the creation date of the
  80.                 most recent member in the archive; not offered if it's already
  81.                 the case
  82.         Del     delete the archive (with confirmation)
  83.         F1      help information
  84.  
  85. These options are presented on the right side of the screen and can be  selected
  86. with the mouse cursor if one is available.
  87.  
  88.  
  89. Specifying parameters:
  90.  
  91. Parameters for this program can be set in the following ways.  The last  setting
  92. encountered always wins:
  93.   - Read from an *.INI file (see BRUCEINI.DOC file),
  94.   - Through the use of an environmental variable (SET AV=whatever), or
  95.   - From the command line (see "Syntax" below)
  96.  
  97.  
  98.  
  99. AV.DOC                               3                         Revised: 11-30-96
  100.  
  101. Syntax:
  102.  
  103.     AV [ filespec ] [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /-MOUSE ]
  104.       [ /Tpath ] [ /Q ] [ /MONO ] [ /Iinitfile | /-I ] [ /? ] [ > filename ]
  105.  
  106. where:
  107.  
  108. "filespec" is the file specification to process.  Can include drive,  path,  and
  109. wildcards if desired.  If no input filespec is provided, you'll be prompted  for
  110. one.
  111.  
  112. "/P" (or "/PAUSE") says to view the directory in page mode.  This  is  typically
  113. the default.  The default is automatically /-P (which can't  be  overridden)  if
  114. redirection ("AV ...  > filename") is used.
  115.  
  116. "/-P" (or "/-PAUSE") says to view the directory not in page mode.  This prevents
  117. you from being offered the fix-date option as well.  This mode is  automatic  if
  118. redirection ("AV ...  > filename") is used.
  119.  
  120. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x"  can
  121. be one of the following:
  122.  
  123.         N = file name
  124.         E = file extension
  125.         D = file date and time
  126.         S = file size of the original (non-compressed) file
  127.         C = current (compressed) size of the file
  128.         R = compression ratio
  129.         P = path and file name order
  130.         O = original order (no sorting)
  131.  
  132. If you precede the "x" with a dash ("-"), the  sort  will  be  done  in  reverse
  133. order.  Initially defaults to /OO.
  134.  
  135. "/DATE" resets the archive file date to be the date of the most  recent  member.
  136. Automatically invokes /-P.  The command "AV *.* /DATE /Q"  is  a  quick  way  to
  137. reset the file date stamps for all archives in your current subdirectory.
  138.  
  139. "/MOUSE" says to activate the mouse if present.  This is initially the default.
  140.  
  141. "/-MOUSE" says to skip activating the mouse even if present.
  142.  
  143. "/Tpath" specifies where to write the temporary  ISAM  files  that  the  routine
  144. needs.  ISAM data bases are used to store and sort the file names.   ISAM  files
  145. cannot be created reliably on certain types of drives.  Examples are "/TC:"  and
  146. "/TC:\TEMP".  If not specified, the routine writes to the following in sequence:
  147.  
  148.   - the value of any TEMP, then TMP, environmental variable
  149.   - C:\TEMP
  150.   - C:\
  151.  
  152. "/Q" skips the display of the member names.  Automatically invokes /DATE and /-P
  153. and is typically used in cases where you want to reset all file dates (e.g.  "AV
  154. *.* /Q").
  155.  
  156.  
  157. AV.DOC                               4                         Revised: 11-30-96
  158.  
  159. "/MONO" (or "/-COLOR") does  not  try  to  override  screen  colors.   Initially
  160. defaults to "/COLOR".
  161.  
  162. "/COLOR" (or "/-MONO") allows screen colors to be overridden.  This is initially
  163. the default.
  164.  
  165. "/Iinitfile" says to read an initialization file with the file name  "initfile".
  166. The file specification *must* contain a period.  Initfiles are described in  the
  167. BRUCEINI.DOC file.  Initially defaults to "/IAV.INI".
  168.  
  169. "/-I" (or "/INULL") says to skip loading the initialization file.
  170.  
  171. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  172.  
  173. ">filename" redirects the output to a text file.  This automatically invokes the
  174. /-P option.  This is useful for getting a complete listing of  the  contents  of
  175. your compressed files.  For example:
  176.  
  177.         AV *.* > TEMP.TXT
  178.  
  179.  
  180. Return codes:
  181.  
  182. AV returns the following ERRORLEVEL codes:
  183.  
  184.         0 = no problems
  185.       252 = other problems
  186.       253 = no valid archives were found
  187.       254 = could not find a decent temporary output subdirectory
  188.       255 = syntax problems, file not found, or /? requested
  189.  
  190.  
  191.  
  192. AV.DOC                               5                         Revised: 11-30-96
  193.  
  194. Author:
  195.  
  196. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  197. and redistribution provided relevant documentation is kept with the program,  no
  198. changes are made to the program or documentation, and it  is  not  bundled  with
  199. commercial programs or charged for separately.  People who need to bundle it  in
  200. for-sale packages must pay a $50 registration fee to  "Wayne  Software"  at  the
  201. following address.
  202.  
  203. Additional information about this and other Wayne Software programs can be found
  204. in the file BRUCE.DOC which should be included in the original  ZIP  file.   The
  205. recent change history for this  and  the  other  programs  is  provided  in  the
  206. HISTORY.ymm file which should be in the same ZIP file where "y" is  replaced  by
  207. the last digit of the year and "mm" is the  two  digit  month  of  the  release;
  208. HISTORY.611 came out in November 1996.  This same naming convention is  used  in
  209. naming the ZIP file (AVymm.ZIP) that this program was included in.
  210.  
  211. Comments and suggestions can also be sent to:
  212.  
  213.                 Bruce Guthrie
  214.                 Wayne Software
  215.                 113 Sheffield St.
  216.                 Silver Spring, MD 20910
  217.  
  218.                 fax: (301) 588-8986
  219.                 e-mail: bguthrie@nmaa.org
  220.                 http://hjs.geol.uib.no/guthrie/
  221.  
  222. Please provide an Internet e-mail address on all correspondence.
  223.  
  224. 
  225.